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The  webapp  Framework 


While  we  could  write  our 
application  using  the  low- 
level  data  provided  to  our 
Python  code,  this  would 
become  very  tedious 

We  would  constantly  be 
reading  a lot  of  Internet 
Standards  documents 


Environment  keys: 

HTTP_COOKIE  : camtoolspref ■ 

SERVER_SOFTWARE  : Development /I . 0 
SCRIPT_NAME  : 

REQUEST_METHOD  : GET 
PATH_INFO  : / 

SERVER_PROTOCOL  : HTTP/1.0 
QUERY_STRINC  : 

CONTENT_LENCTH  : 

HTTP_USER__ACENT  : Mozilla/5.0  (Macintosh;  U;  Inte 
HTTP_CONNECTION  : keep-alive 
S E RVE R_N AME  : localhost 
REMOTE_ADDR  : 127.0.0.1 

PATH_TRANSLATED  : /Users/csev/Desktop/teach/a539- 

SERVERJPORT  : 8081 

AUTH_DOMAIN  : gmail.com 

CURRENT_VERSION_ID  : 1.1 

HTTP_H0ST  : localhost : 8081 

T2  : UTC 

HTTP_CACHE_C0NTR0L  : max-age«0 
USER_EMAIL  : 

HTTP_ACCEPT  : text /xml , application/xml , applicatio 
AP PL I CAT 1 0N_I D : ae-02 -dumper 
G AT  E WA Y_I N T ERF AC E : CCI/1.1 
HTTP_ACCEPT_LANCUACE  : en-us 

C0NTENT_TYPE  : application/x-www-f orm-urlencoded 
HTTP_ACCEPT_ENCODING  : gzipf  deflate 


The  webapp  Framework 


Someone  has  already  written  the  common  code  that 
knows  all  the  details  of  HTTP  (HyperText Transport 
Protocol) 

We  just  import  it  and  then  use  it. 


import  wsgiref.handlers 

from  google.appengine.ext  import  webapp 


import  wsgiref.handlers 


• http://docs.python.org/library/wsgiref.html 


wsgiref  — WSGI  Utilities  and  Reference  Implementation 

New  in  version  2.5. 

The  Web  Server  Gateway  Interface  (WSGI)  is  a standard  interface  between  web  server  software  and  web 
applications  written  in  Python.  Having  a standard  interface  makes  it  easy  to  use  an  application  that  supports  WSGI 
with  a number  of  different  web  servers. 

Only  authors  of  web  servers  and  programming  frameworks  need  to  know  every  detail  and  corner  case  of  the  WSGI 
design.  You  don't  need  to  understand  every  detail  of  WSGI  just  to  install  a WSGI  application  or  to  write  a web 
application  using  an  existing  framework. 

wsgiref  is  a reference  implementation  of  the  WSGI  specification  that  can  be  used  to  add  WSGI  support  to  a web 
server  or  framework.  It  provides  utilities  for  manipulating  WSGI  environment  variables  and  response  headers,  base 
classes  for  implementing  WSGI  servers,  a demo  HTTP  server  that  serves  WSGI  applications,  and  a validation  tool 
that  checks  WSGI  servers  and  applications  for  conformance  to  the  WSGI  specification  (PEP  333). 

See  http://www.wsgi.org  for  more  information  about  WSGI,  and  links  to  tutorials  and  other  resources. 


import  wsgiref.handlers 


• http://docs.python.org/library/wsgiref.html 


wsgiref.handlers  - server/ gateway  base  classes 

This  module  provides  base  handler  classes  for  implementing  WSGI  servers  and  gateways.  These  base  classes 
handle  most  of  the  work  of  communicating  with  a WSGI  application,  as  long  as  they  are  given  a CGI-like 
environment,  along  with  input,  output,  and  error  streams. 

Class  wsgiref.handlers.  CGIHandler 

CGI-based  invocation  via  sys.stdin,  sys.stdout,  sys.stderr  and  os .environ.  This  is  useful  when  you  have  a 
WSGI  application  and  want  to  run  it  as  a CGI  script.  Simply  invoke  cGiHandiero.run(app),  where  app  is  the 
WSGI  application  object  you  wish  to  invoke. 


from  google.appengine.ext 

import  webapp 

http://code.google.com/appengine/docs/python/ 

gettingstarted/usingwebapp.html 
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Using  the  webapp  Framework 


The  CGI  standard  is  simple,  but  it  would  be  cumbersome  to  write  all  of  the  code  that  uses  it  by  hand.  Web 
application  frameworks  handle  these  details  for  you,  so  you  can  focus  your  development  efforts  on  your  application's 
features.  Google  App  Engine  supports  any  framework  written  in  pure  Python  that  speaks  CGI  (and  any 
WSGI-compliant  framework  using  a CGI  adaptor),  including  Dianoo.  CherrvPv.  Pylons,  and  web.py.  You  can  bundle 
a framework  of  your  choosing  with  your  application  code  by  copying  its  code  into  your  application  directory. 

App  Engine  includes  a simple  web  application  framework  of  its  own,  called  webapp.  The  webapp  framework  is 
already  installed  in  the  App  Engine  environment  and  in  the  SDK.  so  you  do  not  need  to  bundle  it  with  your 
application  code  to  use  it.  We  will  use  webapp  for  the  rest  of  this  tutorial. 


Hello,  webapp! 

A webapp  application  has  three  parts: 

• one  or  more  RequestHandler  classes  that  process  requests  and  build  responses 

• a wSGlApplication  instance  that  routes  incoming  requests  to  handlers  based  on  the  URL 

• a main  routine  that  runs  the  WSGlApplication  using  a CGI  adaptor 

Let's  rewrite  our  friendly  greeting  as  a webapp  application.  Edit  helloworld/helloworld.  py  and  replace  its 
contents  with  the  following: 


from  google.appengine.ext  import  webapp 

from  google.appengine.ext. webapp. util  import  run_wsgi_app 


class  MainPage( webapp. RequestHandler) : 
def  get ( self): 

self .response. headers [ 'Content-Type' 


’text/plain' 


Starting  the  Framework 


• Define  our  application  and  the  routing  of  input  URLs  to 
“Handlers” 

• Starting  the  framework  to  process  the  current  request 


def  mainQ: 

application  = webapp.WSGIApplication( 

[('/*',  MainHandler)], 
debug=True) 

wsgiref.handlers.CGIHandler().run(application) 


What  is  a Handler? 


When  we  are  dealing  with  a framework  - at  times  the 
framework  needs  to  ask  us  a question  or  involve  us 
with  some  bit  of  processing. 

Often  this  is  called  “event  processing”  or  “event 
handling” 

Another  word  for  this  is  “callbacks” 

We  register  interest  in  certain  actions  and  then  when 
those  actions  happen  - we  get  called. 


When  you  see  a GET  or  POST 
matching  a URL  pattern,  please 
call  my  MainHandlerQ 


Main 

HandlerQ 


When  you  see  a GET  or  POST 
matching  a URL  pattern,  please  call 
my  MainHandlerA 


MainHandlerQ 


MainHandler() 

I 


MainHandlerQ 


MainHandlerQ 


Starting  the  Framework 


• Sometimes  we  start  the  framework  - and  sometimes  it 
starts  us 

• In  this  example  - we  are  starting  the  framework  and 
giving  it  an  initial  configuration 

def  mainQ: 

application  = webapp.WSGIApplication( 

[('/*',  MainHandler)], 
debug=True) 

wsgiref.handlers.CGIHandler().run(application) 


GET/ 


<html>  ... 


main() 

-4 


webapp() 


Main 

HandlerQ 


Our  main  program  starts  the  framework  and  passes  it  an  initial  list  of 
URL  routes  and  the  name  of  the  handler  code  for  each  route. 


def  mainQ: 

application  = webapp.WSGIApplication([  i — 

MainHandler)],debug=True)  ' ourco  e 

wsgiref.handlers.CGIHandler().run(application)  I framework 


Review:  app.yaml 


The  app.yaml  file  routes 
requests  amongst  different 
Python  scripts.  Within  a 
particular  script,  the  URL  list 
routes  requests  amongst 
handlers. 


application:  ae-03-webapp 
version:  I 
runtime:  python 
api—Version:  I 

handlers: 

- url:  /.* 
script:  index.py 


def  mainQ: 

application  = webapp.WSGIApplication( 

[(V.*',  MainHandler)], 
debug=True) 

wsgiref.handlers.CGIHandler().run(application) 


Review:  app.yaml 

You  route  URLs  in  the  app.yaml 
file  and  in  the  web  application 
framework.  For  our  simple 
application  we  simply  route  all 
URLs  (/.*)  to  the  same  place 
both  in  app.yaml  and  in 
index.py. 


application:  ae-03-webapp 
version:  I 
runtime:  python 
api—Version:  I 

handlers: 

- url:  /.* 
script:  index.py 


def  mainQ: 

application  = webapp.WSGIApplication([ 

Main  Handler)], debug=True) 
wsgiref.handlers.CGIHandler().run(application) 


app.yaml 


<html>  ... 


The  app.yaml  file  answers  the 
question  “which  script?”  Within  a 
particular  script,  the  webapp  routes 
requests  to  handlers. 


Inside  a Handler 


The  purpose  of  a handler  is  to  respond  when  the 
framework  “needs  some  help” 

We  put  methods  in  the  handler  for  get()  and  post() 


GET / POST 


* 


* 


<html>  ... 


main() 


webapp() 


get() 


post() 


Main 

Handler() 


A Pointless  Handler 


class  PointlessHandler(webapp.RequestHandler): 


def  get(self): 

l°gging.info("Hell°  GET") 

def  post(self): 
loggmg.mfoCHell0  POST") 


This  handler  responds  to  GET 
and  POST  requests  and  then 
does  not  do  anything  particularly 
useful.  The  post(  and  get() 
methods  are  the  contact  points 
between  the  webapp  framework 
and  our  code. 


Digression:  Logging 


Web  Application  Logging  is  your  friend 

Your  customers  will  never  tell  you  when  something 
goes  wrong  - they  won’t  call  you  and  tell  you  what 
happened 

So  web  applications  log  to  a file  or  to  a display  - so  you 
can  monitor  what  is  going  on  - even  when  someone 
else  is  using  your  applicaiton 


You  Have  Seen  the  Log 


terminal  — Pythor 

Python 


charles-severances-macbook-pro : apps  csevS  dev_oppserver.py  ae-01-trivial 
INFO  2008-10-19  19:56:14,143  appcfg.py]  Server:  appengine.google.com 

INFO  2008-10-19  19:56:14,155  appcfg.py]  Checking  for  updates  to  the  SDK. 

INFO  2008-10-19  19:56:14,2 77  appcfg.py]  The  SDK  is  up  to  date. 

WARNING  2008-10-19  19:56:14,278  datastore_file_stub.py]  Could  not  read  datastore  data 

from  /var/folders/jW/jW3AfyxcGF09fub-nVQ5uE-*-++TM/-Tmp-/dev_appserver . datastore 
WARNING  2008-10-19  19:56:14,278  datastore_file_stub.py]  Could  not  read  datastore  data 
from  /var/folders/ jW/ jW3AfyxcGF09fub-nVQ5uE+++TM/-Tmp-/dev_appserver . datastore . history 
WARNING  2008-10-19  19:56:14,284  dev_appserver.py]  Could  not  initialize  images  API;  yoi 
are  likely  missing  the  Python  "PIL"  module.  ImportError:  No  module  named  PIL 
INFO  2008-10-19  19:56:14,288  dev_appserver_main.py]  Running  application  ae-01-triv 
al  on  port  8080:  http ://local host: 8080 

INFO  2008-10-19  19:56:16,782  dev.appserver . py]  "GET  / HTTP/1. 1"  200  - 

INFO  2008-10-19  19:56:16,792  dev_appserver_index.py]  Updating  /Users/csev/Desktop/i 

pps/ae-01-tri vial/index . yaml 

INFO  2008-10-19  19:56:16,800  dev.appserver.py]  "GET  /favicon.ico  HTTP/1.1"  200  - 

INFO  2008-10-19  19:56:17,861  dev.appserver.py]  "GET  / HTTP/1. 1"  200  - 

INFO  2008-10-19  19:56:17,875  dev_oppserver.py]  "GET  /favicon.ico  HTTP/1.1"  200  - 

0 


The  log  from  Google 


Google  A pp  Engine 

drchuck@amail.com  1 Mv  Account  1 Help  1 Sian  out 

simplelti  ▼ Version:  1 

« Show  All  Applications 

Dashboard 

Filter  Logs  © 

Logs 

Minimum  Severity:  ErrorT  ©Options 

Datastore 

Tip:  Click  a log  line  to  show  or  hide  its  details.  © Expand  Ioqs 

Indexes 

ffi  10-17  10:07AM  55.555  /upload  500  85ms  276mcycles  Okb 

Data  Viewer 

Ei  10-17  10:07AM  55.636  Traceback  (most  recent  call  last)  File  7base/python_lib/versions/1/google/ 

Administration 

® 10-17  00:40AM  26.858  /upload  500  22ms  59mcycles  Okb 

ADDlication  Settinas 

E 10-17  08:40AM  26.877  Traceback  (most  recent  call  last)  File  7base/python_lib/versions/1/google/ 

Developers 

ffl  10-14  10:08PM  17.189  /upload  500  308ms  995mcycles  Okb 

Versions 

E 10-14  10:08PM  17.489  Traceback  (most  recent  call  last):  File  7base/python_lib/versions/1/google/ 

Errors  in  tl 

he 

Log 

erminal  — bash  — 81x19 


bash 


charles-severances-macbook-pro : apps  csevS  dev_appserver . py  ae-01-trivial 
ERROR  2008-10-19  19:33:37,013  dev_appserver_main . py]  Fatal  error  when  loading 
application  configuration: 

Invalid  object: 

Unknown  url  handler  type. 

<URLMap 

stati  c_di  r-None 
secure«never 
script^lone 
url«/.* 

stati c_f il es^tone 

upload=None 

expi ration=None 

logiooptional 

mime_type=None 

> 

in  ”ae-01-trivial/app.yaml",  line  8,  column  1 
charles-severances-macbook-pro:apps  csevS  [ 


In  Your  Program 


• The  framework  logs  certain  things  on  your  behalf 

• Incoming  GET  and  POST  responses 

• Errors  (including  traceback  information) 

• You  can  add  your  own  logging  messages 

• logging.info(“A  Log  Message”) 

• Five  levels:  debug,  info,  warning,  error  and  critical 

http://code.google.com/appengine/articles/logging.html 


class  PointlessHandler(webapp.RequestHandler): 


def  get(self): 

loggmg.mfoCHdl0  GET") 


def  post(self): 
iQgging.infoC'Hell0  POST") 


Back  to:A  Pointless  Handler 


class  PointlessHandler(webapp.RequestHandler): 


def  get(self): 

l°gging*info("Hello  GET") 

def  post(self): 
logging.infoC'Hell0  POST") 


This  handler,  handles  a GET  and 
POST  request  and  then  does  not 
do  anything  particularly  useful. 
The  post(  and  get()  methods  are 
the  contact  points  between  the 
webapp  framework  and  our  code. 

Our  job  is  to  prepare  the 
response  to  the  GET  and  POST 
requests  in  these  methods. 


The  MainHandler 


class  MainHandler(webapp.RequestHandler): 


def  get(self): 

logging.info("Hello  GET") 
self.dumper() 

def  post(self): 
logging.info("Hello  POST") 
self.dumperQ 


In  addition  to  a happy  little 
log  message,  the  get()  and 
post()  methods  both  call 
dumper()  to  return  a 
response  with  a form  and  the 
dumped  data. 


Review:  Guessing  CGI-Style 


Web  Server 


A 


HTTP 

Request 


POST/ 

Accept:  www/source 

Accept:  text/html 

User-Agent:  Lynx/2.4  libwww/2. 14 

C o nte  n t-ty  pe:  ap  p I i cat  i o n/x- www-fo  r m - 

urlencoded 

Content-length:  8 

guess=25 


<form  method="post"  action='7"> 
<p>Enter  Guess: 

<input  type="text"  name="guess7></p> 
<p><input  type="submit"></p> 

</form> 


import  sys 


index.py 


print  'Content-Type:  text/html' 
print " 

print  '<pre>' 


# Read  the  form  input  which  is  a single  line  as  follows 

# guess=42 

data  = sys.stdin.read() 

# print  data 
try: 

guess  = int(data[data.find('=')+ 1 :]) 
except: 
guess  = - 1 


import  sys 


print  'Content-Type:  text/html' 
print " 

print  '<pre>' 


# Read  the  form  input  which  is  a single  line  as  follows 

# guess=42 

data  = sys.stdin.read() 

# print  data 
try: 

guess  = int(data[data.find('=')+ 1 :]) 
except: 
guess  = - 1 


import  sys  POSt  / 

Accept:  www/source 
print  'Content-Typ Accept:  text/html 


print 

print  '<pre>' 


User-Agent:  Lynx/2.4  libwww/2. 1 4 
Content-type:  application/x-www- 
urlencoded 

# Read  the  form  ir  6 

# guess=42 

data  = sys.stdin.read() 

# print  data 

try: 

guess  = int(data[data.find('=')+ 1 :]) 
except: 
guess  = - 1 


5 6 


guess  = int (data [data . find ('=') +1 :] ) 


import  sys 


print  'Content-Type:  text/html' 
print " 

print  '<pre>' 


# Read  the  form  input  which  is  a single  line  as  follows 

# guess=42 

data  = sys.stdin.read() 

# print  data 

try: 

guess  = int(data[data.find('=')+ 1 :]) 
except: 
guess  = - 1 

print  'Your  guess  is  too  high' 


print  'Your  guess  is',  guess 

answer  = 42 
if  guess  < answer  : 
print  'Your  guess  is  too  low' 
if  guess  ==  answer: 
print  'Congratulations!' 
if  guess  > answer  : 
print  'Your  guess  is  too  high' 


print  '</pre>' 

print  '"<form  method="post"  action='7"> 

<p>Enter  Guess:  <input  type="text"  name="guess'7></p> 
<p><input  type="submit"></p> 


</form>'" 


print  Your  guess  is , guess 

answer  = 42 
if  guess  < answer  : 
print  'Your  guess  is  too  low' 
if  guess  ==  answer: 
print  'Congratulations!' 
if  guess  > answer  : 
print  'Your  guess  is  too  high' 


http:// local  host:  8080/ 

0http://localhost:8O8O/  * 'Q-  Google 

Your  guess  is  -1 
Your  guess  is  too  low 


Enter  Guess: 


print  '</pre>' 

print  m<form  method=Mpost"  action='7"> 

<p>Enter  Guess:  <input  type="text"  name="guess7></p> 
<p><input  type="submit"></p> 


</form>'" 


<juess  again 


app.yaml 

Nothing  is  new  here 


application:  ae-03-webapp 
version:  I 
runtime:  python 
api—Version:  I 


handlers: 

- url :/.* 

script:  index.py 


def  main  ()  : 

application  = webapp . WSGIApplication ( 

[(’/.*’,  MainHandler) ] , 
debug=True) 

wsgiref . handlers . CGIHandler ( ) . run (application) 


if  name ==  ’ main 

main ( ) 


Bottom  of  file 


import  logging 
import  wsgiref . handlers 

from  google . appengine . ext  import  webapp 

class  MainHandler (webapp . RequestHandler) : 

formstring  = f ' ' <form  method="post"  action="/"> 
<p>Enter  Guess:  <input  type="text"  name=,,guessn/X/p> 
<pXinput  type=" submit" X/p> 

</form>! ' ' 

def  get (self) : 

self . response . out . write ( ' <p>Good  luck ! </p>\n ' ) 
self . response . out .write (self . formstring) 


# still  defining  class  "MainHandler" 
def  post (self) : 

stguess  = self .request. get ( f guess f ) 
logging . info ( ' User  guess= ' tstguess) 
try: 

guess  = int (stguess) 
except : 

guess  = -1 

answer  = 42 
if  guess  ==  answer: 

msg  = ' Congratulations ' 
elif  guess  < 0 : 

msg  = ' Please  provide  a number  guess 
elif  guess  < answer: 


# still  defining  ’post’  method  in  class  "MainHandler" 

answer  = 42 
if  guess  ==  answer: 

msg  = ' Congratulations ' 
elif  guess  < 0 : 

msg  = 1 Please  provide  a number  guess 1 
elif  guess  < answer: 

msg  = 'Your  guess  is  too  low' 
else : 

msg  = 'Your  guess  is  too  high' 

self . response . out .write ( '<p>Guess : ' +stguess+ '</p>\n ' ) 
self . response . out . write ( ' <p> ' +msg+ ' </p>\n ' ) 
self . response . out .write (self . formstring) 


We  Don’t  Use  print 


Our  task  is  to  prepare  the  response  and  give  it  back  to 
the  framework  - so  instead  of  just  printing  the  output, 
we  call 

• self.response.out.write(“Some  String”) 

This  lets  the  framework  do  something  tricky  (or  Cloud- 
Like)  with  our  response  - if  it  so  desires 


def  main() : 

application  = webapp .WSGI Application ( 

[('/.* ' , MainHandler) ] , 
debug=True) 

wsgiref . handlers . CGIHandler ( ) . run (application) 

if  name ==  ' main ' : 

main ( ) 


Bottom  of  file 


Summary 


We  are  now  using  the  webapp  framework  provided  by 
Google  to  handle  the  low-level  details  of  the  Request/ 
Response  cycle  and  data  formats 

We  create  a Handler  to  handle  the  incoming  requests 
and  then  start  the  webapp  framework  to  handle  the 
requests  and  call  our  Handler  as  needed 

In  a web  application,  log  messages  are  your  friend! 


